<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en-US">
<head>
<!-- GenHTML revision 25226-->
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
<title>Required Software - The Java EE 6 Tutorial</title>
<meta name="robots" content="index,follow">
<meta name="robots" content="index,follow">
<meta name="date" content="2011-03-01">
<link rel="stylesheet" type="text/css" href="css/default.css">
<link rel="stylesheet" type="text/css" href="css/ipg.css">
<link rel="stylesheet" type="text/css" href="css/javaeetutorial.css">
</head>

<body>

<table border="0" cellpadding="5" cellspacing="0" width="100%">
<tbody>
   <tr valign="top">
      <td width="400px"><p class="toc level1"><a href="docinfo.html">Document Information</a></p>
<p class="toc level1 tocsp"><a href="gexaf.html">Preface</a></p>
<p class="toc level1 tocsp"><a href="gfirp.html">Part&nbsp;I&nbsp;Introduction</a></p>
<p class="toc level2"><a href="bnaaw.html">1.&nbsp;&nbsp;Overview</a></p>
<p class="toc level2"><a href="gfiud.html">2.&nbsp;&nbsp;Using the Tutorial Examples</a></p>
<div id="scrolltoc" class="onpage">
<p class="toc level3"><a href="">Required Software</a></p>
<p class="toc level4"><a href="#gexae">Java Platform, Standard Edition</a></p>
<p class="toc level4"><a href="#gexab">Java EE 6 Software Development Kit</a></p>
<p class="toc level5"><a href="#gexbc">SDK Installation Tips</a></p>
<p class="toc level4 tocsp"><a href="#gexba">Java EE 6 Tutorial Component</a></p>
<p class="toc level5"><a href="#giqtt">To Obtain the Tutorial Component Using the Update Tool</a></p>
<p class="toc level4 tocsp"><a href="#gexaz">NetBeans IDE</a></p>
<p class="toc level5"><a href="#gjseq">To Install NetBeans IDE without GlassFish Server</a></p>
<p class="toc level5"><a href="#giqzl">To Add GlassFish Server as a Server in NetBeans IDE</a></p>
<p class="toc level4 tocsp"><a href="#gexaa">Apache Ant</a></p>
<p class="toc level5"><a href="#giqsf">To Obtain Apache Ant</a></p>
</div>
<p class="toc level3 tocsp"><a href="bnadi.html">Starting and Stopping the GlassFish Server</a></p>
<p class="toc level3"><a href="bnadj.html">Starting the Administration Console</a></p>
<p class="toc level4"><a href="bnadj.html#gjkst">To Start the Administration Console in NetBeans IDE</a></p>
<p class="toc level3 tocsp"><a href="bnadk.html">Starting and Stopping the Java DB Server</a></p>
<p class="toc level4"><a href="bnadk.html#gjsfs">To Start the Database Server Using NetBeans IDE</a></p>
<p class="toc level3 tocsp"><a href="bnaan.html">Building the Examples</a></p>
<p class="toc level3"><a href="gexap.html">Tutorial Example Directory Structure</a></p>
<p class="toc level3"><a href="giqwr.html">Getting the Latest Updates to the Tutorial</a></p>
<p class="toc level4"><a href="giqwr.html#giqyk">To Update the Tutorial Through the Update Center</a></p>
<p class="toc level3 tocsp"><a href="bnadl.html">Debugging Java EE Applications</a></p>
<p class="toc level4"><a href="bnadl.html#bnadm">Using the Server Log</a></p>
<p class="toc level5"><a href="bnadl.html#gjsgh">To Use the Log Viewer</a></p>
<p class="toc level4 tocsp"><a href="bnadl.html#bnadn">Using a Debugger</a></p>
<p class="toc level5"><a href="bnadl.html#gjqwl">To Debug an Application Using a Debugger</a></p>
<p class="toc level1 tocsp"><a href="bnadp.html">Part&nbsp;II&nbsp;The Web Tier</a></p>
<p class="toc level2"><a href="bnadr.html">3.&nbsp;&nbsp;Getting Started with Web Applications</a></p>
<p class="toc level2"><a href="bnaph.html">4.&nbsp;&nbsp;JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="giepx.html">5.&nbsp;&nbsp;Introduction to Facelets</a></p>
<p class="toc level2"><a href="gjddd.html">6.&nbsp;&nbsp;Expression Language</a></p>
<p class="toc level2"><a href="bnaqz.html">7.&nbsp;&nbsp;Using JavaServer Faces Technology in Web Pages</a></p>
<p class="toc level2"><a href="gjcut.html">8.&nbsp;&nbsp;Using Converters, Listeners, and Validators</a></p>
<p class="toc level2"><a href="bnatx.html">9.&nbsp;&nbsp;Developing with JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="gkmaa.html">10.&nbsp;&nbsp;JavaServer Faces Technology Advanced Concepts</a></p>
<p class="toc level2"><a href="bnawo.html">11.&nbsp;&nbsp;Configuring JavaServer Faces Applications</a></p>
<p class="toc level2"><a href="gkiow.html">12.&nbsp;&nbsp;Using Ajax with JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="gkhxa.html">13.&nbsp;&nbsp;Advanced Composite Components</a></p>
<p class="toc level2"><a href="bnavg.html">14.&nbsp;&nbsp;Creating Custom UI Components</a></p>
<p class="toc level2"><a href="bnafd.html">15.&nbsp;&nbsp;Java Servlet Technology</a></p>
<p class="toc level2"><a href="bnaxu.html">16.&nbsp;&nbsp;Internationalizing and Localizing Web Applications</a></p>
<p class="toc level1 tocsp"><a href="bnayk.html">Part&nbsp;III&nbsp;Web Services</a></p>
<p class="toc level2"><a href="gijti.html">17.&nbsp;&nbsp;Introduction to Web Services</a></p>
<p class="toc level2"><a href="bnayl.html">18.&nbsp;&nbsp;Building Web Services with JAX-WS</a></p>
<p class="toc level2"><a href="giepu.html">19.&nbsp;&nbsp;Building RESTful Web Services with JAX-RS</a></p>
<p class="toc level2"><a href="gjjxe.html">20.&nbsp;&nbsp;Advanced JAX-RS Features</a></p>
<p class="toc level2"><a href="gkojl.html">21.&nbsp;&nbsp;Running the Advanced JAX-RS Example Application</a></p>
<p class="toc level1 tocsp"><a href="bnblr.html">Part&nbsp;IV&nbsp;Enterprise Beans</a></p>
<p class="toc level2"><a href="gijsz.html">22.&nbsp;&nbsp;Enterprise Beans</a></p>
<p class="toc level2"><a href="gijre.html">23.&nbsp;&nbsp;Getting Started with Enterprise Beans</a></p>
<p class="toc level2"><a href="gijrb.html">24.&nbsp;&nbsp;Running the Enterprise Bean Examples</a></p>
<p class="toc level2"><a href="bnbpk.html">25.&nbsp;&nbsp;A Message-Driven Bean Example</a></p>
<p class="toc level2"><a href="gkcqz.html">26.&nbsp;&nbsp;Using the Embedded Enterprise Bean Container</a></p>
<p class="toc level2"><a href="gkidz.html">27.&nbsp;&nbsp;Using Asynchronous Method Invocation in Session Beans</a></p>
<p class="toc level1 tocsp"><a href="gjbnr.html">Part&nbsp;V&nbsp;Contexts and Dependency Injection for the Java EE Platform</a></p>
<p class="toc level2"><a href="giwhb.html">28.&nbsp;&nbsp;Introduction to Contexts and Dependency Injection for the Java EE Platform</a></p>
<p class="toc level2"><a href="gjbls.html">29.&nbsp;&nbsp;Running the Basic Contexts and Dependency Injection Examples</a></p>
<p class="toc level2"><a href="gjehi.html">30.&nbsp;&nbsp;Contexts and Dependency Injection for the Java EE Platform: Advanced Topics</a></p>
<p class="toc level2"><a href="gkhre.html">31.&nbsp;&nbsp;Running the Advanced Contexts and Dependency Injection Examples</a></p>
<p class="toc level1 tocsp"><a href="bnbpy.html">Part&nbsp;VI&nbsp;Persistence</a></p>
<p class="toc level2"><a href="bnbpz.html">32.&nbsp;&nbsp;Introduction to the Java Persistence API</a></p>
<p class="toc level2"><a href="gijst.html">33.&nbsp;&nbsp;Running the Persistence Examples</a></p>
<p class="toc level2"><a href="bnbtg.html">34.&nbsp;&nbsp;The Java Persistence Query Language</a></p>
<p class="toc level2"><a href="gjitv.html">35.&nbsp;&nbsp;Using the Criteria API to Create Queries</a></p>
<p class="toc level2"><a href="gkjiq.html">36.&nbsp;&nbsp;Creating and Using String-Based Criteria Queries</a></p>
<p class="toc level2"><a href="gkjjf.html">37.&nbsp;&nbsp;Controlling Concurrent Access to Entity Data with Locking</a></p>
<p class="toc level2"><a href="gkjia.html">38.&nbsp;&nbsp;Improving the Performance of Java Persistence API Applications By Setting a Second-Level Cache</a></p>
<p class="toc level1 tocsp"><a href="gijrp.html">Part&nbsp;VII&nbsp;Security</a></p>
<p class="toc level2"><a href="bnbwj.html">39.&nbsp;&nbsp;Introduction to Security in the Java EE Platform</a></p>
<p class="toc level2"><a href="bncas.html">40.&nbsp;&nbsp;Getting Started Securing Web Applications</a></p>
<p class="toc level2"><a href="bnbyk.html">41.&nbsp;&nbsp;Getting Started Securing Enterprise Applications</a></p>
<p class="toc level1 tocsp"><a href="gijue.html">Part&nbsp;VIII&nbsp;Java EE Supporting Technologies</a></p>
<p class="toc level2"><a href="gijto.html">42.&nbsp;&nbsp;Introduction to Java EE Supporting Technologies</a></p>
<p class="toc level2"><a href="bncih.html">43.&nbsp;&nbsp;Transactions</a></p>
<p class="toc level2"><a href="bncjh.html">44.&nbsp;&nbsp;Resource Connections</a></p>
<p class="toc level2"><a href="bncdq.html">45.&nbsp;&nbsp;Java Message Service Concepts</a></p>
<p class="toc level2"><a href="bncgv.html">46.&nbsp;&nbsp;Java Message Service Examples</a></p>
<p class="toc level2"><a href="gkahp.html">47.&nbsp;&nbsp;Advanced Bean Validation Concepts and Examples</a></p>
<p class="toc level2"><a href="gkeed.html">48.&nbsp;&nbsp;Using Java EE Interceptors</a></p>
<p class="toc level1 tocsp"><a href="gkgjw.html">Part&nbsp;IX&nbsp;Case Studies</a></p>
<p class="toc level2"><a href="gkaee.html">49.&nbsp;&nbsp;Duke's Tutoring Case Study Example</a></p>
<p class="toc level1 tocsp"><a href="idx-1.html">Index</a></p>
</td>
      <td width="10px">&nbsp;</td>
      <td>
         <div class="header">
             <div class="banner">
                <table width="100%" border="0" cellpadding="5" cellspacing="0">
                   <tbody>
                      <tr>
                         <td valign="bottom"><p class="Banner">The Java EE 6 Tutorial
</p></td>
                         <td align="right"  valign="bottom"><img src="graphics/javalogo.png" alt="Java Coffee Cup logo"></td>
                      </tr>
                   </tbody>
                </table>
             </div>

             <div class="header-links">
	         <a href="./index.html">Home</a> | 
<a href="../information/download.html">Download</a> | 
<a href="./javaeetutorial6.pdf">PDF</a> | 
<a href="../information/faq.html">FAQ</a> | 
<a href="http://download.oracle.com/javaee/feedback.htm">Feedback</a>

             </div>
             <div class="navigation">
                 <a href="gfiud.html"><img src="graphics/leftButton.gif" border="0" alt="Previous" title="Previous"></a>
                 <a href="p1.html"><img src="graphics/upButton.gif" border="0" alt="Contents" title="Contents"></a>
                 <a href="bnadi.html"><img src="graphics/rightButton.gif" border="0" alt="Next" title="Next"></a>
             </div>
         </div>

	 <div class="maincontent">      	 
             

<a name="gexaj"></a><h2>Required Software</h2>
<a name="indexterm-143"></a><p>The following software is required to run the examples:</p>


<ul><li><p><a href="#gexae">Java Platform, Standard Edition</a></p>

</li>
<li><p><a href="#gexab">Java EE 6 Software Development Kit</a></p>

</li>
<li><p><a href="#gexba">Java EE 6 Tutorial Component</a></p>

</li>
<li><p><a href="#gexaz">NetBeans IDE</a></p>

</li>
<li><p><a href="#gexaa">Apache Ant</a></p>

</li></ul>


<a name="gexae"></a><h3>Java Platform, Standard Edition</h3>
<p>To build, deploy, and run the examples, you need a copy of
the Java Platform, Standard Edition 6.0 Development Kit (JDK 6). You can download the
JDK 6 software from <a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">http://www.oracle.com/technetwork/java/javase/downloads/index.html</a>.</p>

<p>Download the current JDK update that does not include any other software, such
as NetBeans IDE or the Java EE SDK.</p>



<a name="gexab"></a><h3>Java EE 6 Software Development Kit</h3>
<p><a name="indexterm-144"></a><a name="indexterm-145"></a><a name="indexterm-146"></a>GlassFish Server Open Source Edition 3.1.1 is targeted as the build and runtime
environment for the tutorial examples. To build, deploy, and run the examples, you
need a copy of the GlassFish Server and, optionally, NetBeans IDE. To obtain
the GlassFish Server, you must install the Java EE 6 Software Development Kit
(SDK), which you can download from <a href="http://www.oracle.com/technetwork/java/javaee/downloads/index.html">http://www.oracle.com/technetwork/java/javaee/downloads/index.html</a>. Make sure you download the
Java EE 6 SDK, not the Java EE 6 Web Profile SDK.</p>



<a name="gexbc"></a><h4>SDK Installation Tips</h4>
<p>During the installation of the SDK, do the following.</p>


<ul><li><p>Configure the GlassFish Server administration user name as <tt>admin</tt>, and specify no password. This is the default setting.</p>

</li>
<li><p>Accept the default port values for the Admin Port (4848) and the HTTP Port (8080).</p>

</li>
<li><p>Allow the installer to download and configure the Update Tool. If you access the Internet through a firewall, provide the proxy host and port. </p>

</li></ul>
<p>This tutorial refers to <i>as-install-parent</i>, the directory where you install the GlassFish Server.
For example, the default installation directory on Microsoft Windows is <tt>C:\glassfishv3</tt>, so <i>as-install-parent</i>
is <tt>C:\glassfishv3</tt>.  The GlassFish Server itself is installed in <i>as-install</i>, the <tt>glassfish</tt>
directory under <i>as-install-parent</i>. So on Microsoft Windows, <i>as-install</i> is <tt>C:\glassfishv3\glassfish</tt>.</p>

<p>After you install the GlassFish Server, add the following directories to your <tt>PATH</tt>
to avoid having to specify the full path when you use commands:</p>

<pre><tt></tt><i>as-install-parent</i><tt>/bin</tt></pre><pre><tt></tt><i>as-install</i><tt>/bin</tt></pre>

<a name="gexba"></a><h3>Java EE 6 Tutorial Component</h3>
<p>The tutorial example source is contained in the tutorial component. To obtain the
tutorial component, use the Update Tool.</p>



<a name="giqtt"></a><h4>To Obtain the Tutorial Component Using the Update Tool</h4>
<ol>
<li><b>Start the Update Tool.</b><ul>
<li><b>From the command line, type the command <tt><b>updatetool</b></tt>.</b></li>
<li><b>On a Windows system, from the Start menu, choose All Programs, then chooseJava
EE 6 SDK, then choose Start Update Tool.</b></li></ul></li>
<li><b>Expand the GlassFish Server Open Source Edition node.</b></li>
<li><b>Select the Available Add-ons node.</b></li>
<li><b>From the list, select the Java EE 6 Tutorial check box.</b></li>
<li><b>Click Install.</b></li>
<li><b>Accept the license agreement.</b><p>After installation, the Java EE 6 Tutorial appears in the list of installed
components. The tool is installed in the <tt></tt><i>as-install</i><tt>/docs/javaee-tutorial</tt> directory. This directory contains two subdirectories:
<tt>docs</tt> and <tt>examples</tt>. The <tt>examples</tt> directory contains subdirectories for each of the technologies
discussed in the tutorial.</p></li></ol><p></b>Next Steps</b></p><p>Updates to the Java EE 6 Tutorial are published periodically. For details on
obtaining these updates, see <a href="giqwr.html">Getting the Latest Updates to the Tutorial</a>.</p>



<a name="gexaz"></a><h3>NetBeans IDE</h3>
<a name="indexterm-147"></a><p>The NetBeans integrated development environment (IDE) is a free, open-source IDE for developing
Java applications, including enterprise applications. NetBeans IDE supports the Java EE platform. You
can build, package, deploy, and run the tutorial examples from within NetBeans IDE.</p>

<p>To run the tutorial examples, you need the latest version of NetBeans
IDE. You can download NetBeans IDE from <a href="http://www.netbeans.org/downloads/index.html">http://www.netbeans.org/downloads/index.html</a>. Make sure that you download the
Java EE bundle.</p>



<a name="gjseq"></a><h4>To Install NetBeans IDE without GlassFish Server</h4>
<p>When you install NetBeans IDE, do not install the version of GlassFish
Server that comes with NetBeans IDE. To skip the installation of GlassFish Server,
follow these steps.</p>

<ol>
<li><b>Click Customize on the first page of the NetBeans IDE Installer wizard.</b></li>
<li><b>In the Customize Installation dialog, deselect the check box for GlassFish Server
and click OK.</b></li>
<li><b>Continue with the installation of NetBeans IDE.</b></li></ol><p></b>Next Steps</b></p><p>The first time you start NetBeans IDE, a dialog box asks you
if you want to download and install the JUnit testing library. A few
of the tutorial examples use this library, so you should install it.</p>



<a name="giqzl"></a><h4>To Add GlassFish Server as a Server in NetBeans IDE</h4>
<p>To run the tutorial examples in NetBeans IDE, you must add your
GlassFish Server as a server in NetBeans IDE. Follow these instructions to add
the GlassFish Server to NetBeans IDE.</p>

<ol>
<li><b>From the Tools menu, choose Servers.</b><p>The Servers wizard opens.</p></li>
<li><b>Click Add Server.</b></li>
<li><b>Under Choose Server, select GlassFish Server 3.x and click Next.</b></li>
<li><b>Under Server Location, browse to the location of your GlassFish Server installation and
click Next.</b></li>
<li><b>Under Domain Location, select Register Local Domain.</b></li>
<li><b>Click Finish.</b></li></ol>

<a name="gexaa"></a><h3>Apache Ant</h3>
<a name="indexterm-148"></a><p>Ant is a Java technology-based build tool developed by the Apache Software Foundation
(<a href="http://ant.apache.org/">http://ant.apache.org/</a>) and is used to build, package, and deploy the tutorial examples. To
run the tutorial examples, you need Ant 1.7.1 or higher. If you do
not already have Ant, you can install it from the Update Tool that
is part of the GlassFish Server.</p>



<a name="giqsf"></a><h4>To Obtain Apache Ant</h4>
<ol>
<li><b>Start the Update Tool.</b><ul>
<li><b>From the command line, type the command <tt><b>updatetool</b></tt>.</b></li>
<li><b>On a Windows system, from the Start menu, choose All Programs, then choose
Java EE 6 SDK, then choose Start Update Tool.</b></li></ul></li>
<li><b>Expand the GlassFish Server Open Source Edition node.</b></li>
<li><b>Select the Available Add-ons node.</b></li>
<li><b>From the list, select the Apache Ant Build Tool check box.</b></li>
<li><b>Click Install.</b></li>
<li><b>Accept the license agreement.</b><p>After installation, Apache Ant appears in the list of installed components. The tool
is installed in the <tt></tt><i>as-install-parent</i><tt>/ant</tt> directory.</p></li></ol><p></b>Next Steps</b></p><p>To use the <tt>ant</tt> command, add <tt></tt><i>as-install-parent</i><tt>/ant/bin</tt> to your <tt>PATH</tt> environment variable.</p>


         </div>
         <div class="navigation">
             <a href="gfiud.html"><img src="graphics/leftButton.gif" border="0" alt="Previous" title="Previous"></a>
             <a href="p1.html"><img src="graphics/upButton.gif" border="0" alt="Contents" title="Contents"></a>
             <a href="bnadi.html"><img src="graphics/rightButton.gif" border="0" alt="Next" title="Next"></a>
         </div>

         <div class="copyright">
      	    <p>Copyright &copy; 2011, Oracle and/or its affiliates. All rights reserved. <a href="docinfo.html">Legal Notices</a></p>
      	 </div>

      </td>
   </tr>
</tbody>
</table>
</body>
</html>

